home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 6 / PC World Interactive 6.iso / online / settm1.exe / SETTIME.DOC < prev    next >
Text File  |  1994-05-02  |  9KB  |  208 lines
  1. SetTime, Version 1.1
  2.  
  3.     Written by Tony Isaac
  4.     Completed May 2, 1994
  5.  
  6.     If you have any questions, comments, or suggestions, please send me e-mail
  7.     via the Internet (t.isaac@genie.geis.com) or GEnie (T.ISAAC).  To send
  8.     Internet mail from CompuServe, use the normal mail system and use the
  9.     address ">INTERNET:t.isaac@genie.geis.com" (minus the quotes).
  10.  
  11.     This program uses your modem to dial the NIST atomic clock in Boulder,
  12.     Colorado, and sets your PC's clock to within a second or so of the time
  13.     signal sent by that clock.
  14.  
  15.     This program was written using VisualBasic 3.0 for Windows.
  16.     While this program has been tested and is in use in real applications, it 
  17.     is NOT guaranteed to be bug-free.  If you do find a problem, please let me 
  18.     know, and I will do my best to correct the situation.  However, since this
  19.     is free, there are NO guarantees.
  20.  
  21. License
  22.     
  23.     This program is FREEWARE, and is not to be sold.  Please distribute this 
  24.     software as much as you wish, but in no case is any charge to be assessed
  25.     for this software or its use.  No alterations are permitted to this
  26.     software or its documentation without permission from the author.
  27.  
  28. Required Files
  29.  
  30.     This archive includes all the files necessary to run this program, except
  31.     for VBRUN300.DLL, which is commonly available on CompuServe, GEnie, 
  32.     America Online, and other bulletin boards.  If you cannot locate this 
  33.     file, please contact me by e-mail, and I will be happy to help you locate
  34.     a copy.
  35.  
  36.     Other required files that are included:
  37.  
  38.         SETTIME.EXE    Main Windows executable
  39.         KEYSTAT.VBX    Handles keystrokes
  40.         MSCOMM.VBX     Handles serial communications
  41.         THREED.VBX     Allows the program to use three-dimensional controls
  42.  
  43. Installation
  44.  
  45.     SETTIME.EXE may be placed wherever you wish.  The .VBX files and 
  46.     VBRUN300.DLL may be placed either in the directory with SETTIME.EXE or in 
  47.     the WINDOWS\SYSTEM directory.
  48.  
  49.     Once the files are copied to their appropriate places, run SETTIME.EXE.
  50.     If this is the first time you are running SetTime (any version), a setup 
  51.     dialog box will appear.  Click the Help button for instructions for 
  52.     setting the proper values for each field.  After setting all the options 
  53.     correctly, click the Save button to save your settings in the SETTIME.INI
  54.     file, which will be created automatically the first time you run this 
  55.     program, and will be placed in your WINDOWS directory along with all your
  56.     other .INI files.  
  57.     
  58.     When you are finished with the Setup dialog box, click OK to return to
  59.     the main SetTime window.  Click the Dial button in the main window to 
  60.     dial the NIST clock and set your computer's time.
  61.  
  62.     If you want to run SetTime from a Windows script language, you may want
  63.     to use the /quick command line option.  Starting SetTime with the /quick
  64.     option will cause it to immediately dial, set the time, and exit, without
  65.     any user intervention.
  66.  
  67. Running the Program
  68.  
  69.     The first time you run SetTime, it will present you with a configuration
  70.     dialog box.  Click the Help button if you need assistance deciding what
  71.     settings to use for your computer.  There is also some information below
  72.     under "Modem Setup Strings" that may be helpful if SetTime doesn't seem 
  73.     to work with your modem.  If you have tried all the suggestions, please
  74.     don't hesitate to contact me via e-mail (my address is listed below).
  75.  
  76.     Once your settings are saved, you should not have to re-configure unless
  77.     you change equipment.  Simply press the "Dial" button on the main SetTime
  78.     window and let the program do the work.
  79.  
  80.     In some special situations, it may be necessary to type special commands
  81.     directly to your modem.  Beginning in version 1.0, it is possible to
  82.     type modem commands directly into the monitor window.  This would allow
  83.     for remote logins and other unusual circumstances.
  84.     
  85. Modem Setup Strings
  86.  
  87.     Modem setup is always difficult because there is no set standard way to 
  88.     do things, and it seems that no two modems are alike.  It may take 
  89.     several tries to get the right init string.  If you find a string that 
  90.     works, by all means, use it.  Don't worry that it might not be the 
  91.     "correct" string.  
  92.     
  93.     If everything seems to be set correctly and the program still doesn't
  94.     function properly, here are some things to try:
  95.  
  96.     First, try setting the program's baud rate to 1200 (not faster).  The 
  97.     NIST modems use 1200 baud, so setting the program's speed to a faster 
  98.     rate won't help.  Changing the baud rate to 1200 has corrected problems 
  99.     connecting to NIST for several people.  If you have done this and still 
  100.     get no response, please double-check the following:
  101.  
  102.     1. Async echo should be ON (the modem should echo back AT commands when
  103.     not connected).  When the dial screen comes up, you shold see the AT 
  104.     commands you are sending to the modem, as well as the modem's responses.
  105.  
  106.     2. Flow control should be OFF (do NOT use XON/XOFF, DTR/CTS, or RTS/CTS 
  107.     flow control).  If this setting is incorrect, the monitor window of the
  108.     Dial screen will probably remain blank.
  109.  
  110.     3. The modem should be set so that toggling DTR from HIGH to LOW 
  111.     disconnects the modem.  If this setting is wrong, the program will still 
  112.     work; it just won't hang up when it is finished.
  113.  
  114.     4. If none of this helps, you may contact me at the address listed below,
  115.     or by e-mail on CompuServe, GEnie, or the Internet.
  116.  
  117. Addresses
  118.  
  119.     Tony Isaac
  120.     10200 Belle Rive Blvd.  
  121.     Apt. #124
  122.     Jacksonville, FL  32256
  123.  
  124.     Internet: t.isaac@genie.geis.com
  125.     CompuServe: >INTERNET:t.isaac@genie.geis.com
  126.     GEnie: T.ISAAC
  127.  
  128. Description of SETTIME.INI
  129.  
  130. [Setup] section
  131.     Time Zones=Atlantic,Eastern,Central,Mountain,Pacific
  132.         This is a list of time zones known to this program.  If you manually
  133.         add time zones to this list, make sure you also add a corresponding 
  134.         entry to the [Time Zones] section.
  135.     Local Time Zone=Central
  136.         This should be your local time zone, but must be in the Time Zones
  137.         list above.
  138.     Serial Port=COM1
  139.         The COM port for your modem.
  140.     Baud Rates=1200,2400,4800,9600,19200,38400
  141.         This is the list of baud rates that will be displayed in the pop-up 
  142.         list on the setup screen.
  143.     Current Baud Rate=9600
  144.         The baud rate used to communicate with your modem.  This should be at
  145.         least 1200, and must be in the Baud Rates list above.
  146.     Modem Init String=ATZ
  147.         The setup string for you modem.  This should turn flow control off, 
  148.         async echo on, and set DTR to disconnect when toggled from high to low.
  149.         Since no two modems are alike, you will have to consult your modem's 
  150.         manual for the proper string.
  151.     Dial Prefix=ATDT
  152.         The command to dial your modem.  This can also be followed by 9 for an
  153.         outside line, *70 to disable call waiting, or any other string as
  154.         required by your situation.
  155.     Phone Number=1(303)494-4774
  156.         The phone number for the NIST atomic clock.
  157.     Disable DST=No
  158.         Set this to Yes ONLY if your area NEVER switches to Daylight Savings
  159.         Time.
  160.     Timeout=40
  161.         This is the number of seconds SetTime will wait for a time signal
  162.         from NIST after beginning to dial.  If a valid time signal is not 
  163.         received within that time, SetTime will hang up your modem and try
  164.         again.
  165.     Retries=5
  166.         If the line is busy, or a timeout occurs, SetTime will hang up and
  167.         try again, up to the number of times specified by this setting.
  168.  
  169. [Time Zones] section
  170.     Atlantic=-4
  171.     Eastern=-5
  172.     Central=-6
  173.     Mountain=-7
  174.     Pacific=-8
  175.         Each time zone listed above in the [Setup] Time Zones entry should
  176.         have an entry here.  The number in each case is the number of hours
  177.         difference between the time zone and GMT.  Since this program 
  178.         automatically adjusts for Daylight Savings Time, use the offset for
  179.         standard time.
  180.  
  181. Format of Data Sent by NIST Clock
  182.  
  183.     Each second, a line with the following form is sent:
  184.         JJJJJ YY-MM-DD HH:MM:SS TT L UT1 msADV UTC(NIST) *
  185.  
  186.     JJJJJ = Julian date since 1/1/-4713 (minus 2.4 million)
  187.  
  188.     YY-MM-DD = Current date (GMT)    
  189.     
  190.     HH:MM:SS = Current time (GMT, 24-hour clock)
  191.  
  192.     TT: 00 = standard time
  193.         01-49 = daylight time, TT days until standard time
  194.         50 = daylight time
  195.         51-99 = standard time, TT days until daylight time
  196.  
  197.     L: 1 = Leap second added at midnight tonight; otherwise 0
  198.  
  199.     UT1 = Correction factor for older time measurements
  200.  
  201.     msADV = Milliseconds time code is sent in advance of actual time (allowing
  202.         for transmission delays)
  203.  
  204.     * = Time mark
  205.  
  206.     (See BYTE Magazine, October 1993, p. 60 for complete details)
  207.  
  208.